================================================================================
  OjarLang 文本标签映射文档 (Text & Paragraph Tags Mapping)
  Version: 0.1
  Author: BlackStop
  Description: 将 HTML 中的文本类标签映射为 OjarLang 关键字
================================================================================

.
. 一、标题系列 (Headings)
. ------------------------------------------------------------------------------
. HTML 中有 h1 ~ h6 六级标题，在 OjarLang 中映射为 title ~ title6
.

关键字      HTML 等价       说明
─────       ─────────       ─────────────────────────────────────────
title       <h1>            一级标题，页面最大标题
title2      <h2>            二级标题，章节标题
title3      <h3>            三级标题，小节标题
title4      <h4>            四级标题
title5      <h5>            五级标题
title6      <h6>            六级标题，最小标题

. 使用示例：
title "Welcome to BlackStop";
title2 "关于我";
title3 "联系方式";

. 编译产物：
<h1>Welcome to BlackStop</h1>
<h2>关于我</h2>
<h3>联系方式</h3>


.
. 二、段落与文本 (Paragraphs & Text)
. ------------------------------------------------------------------------------
. HTML 中的 <p> <span> <div> 等文本容器
.

关键字      HTML 等价       说明
─────       ─────────       ─────────────────────────────────────────
text        <p>             段落文本，自动换行，上下有间距
line        <span>          行内文本，不换行，用于段落中局部样式
block       <div>           块级容器，用于包裹一组元素
raw         (无标签)        纯文本输出，不做任何包装

. 使用示例：
text "起床战争打的十分的菜，PVP 也不怎么样";
line "这段是行内的" <color=red>;
block {
    text "第一段";
    text "第二段";
};
raw "这段不会被任何标签包裹";

. 编译产物：
<p>起床战争打的十分的菜，PVP 也不怎么样</p>
<span style="color:red;">这段是行内的</span>
<div>
    <p>第一段</p>
    <p>第二段</p>
</div>
这段不会被任何标签包裹


.
. 三、文本样式 (Text Styling)
. ------------------------------------------------------------------------------
. HTML 中的 <b> <i> <u> <strong> <em> <mark> 等
. 注意：这些不是独立关键字，而是 text/line 的修饰符
.

关键字      HTML 等价       说明
─────       ─────────       ─────────────────────────────────────────
bold        <strong>        加粗（语义化强调）
italic      <em>            斜体（语义化强调）
underline   <u>             下划线
strike      <del>           删除线
highlight   <mark>          高亮背景色
code        <code>          等宽字体，用于代码片段
small       <small>         小号字
sub         <sub>           下标
sup         <sup>           上标

. 使用示例：
text "这是一段文字，其中" + bold "重要" + "的部分会被加粗";
text "价格：" + strike "99元" + " 现价 49元";
text "快捷键是" + code "Ctrl+C" + "复制";
text "水的化学式是 H" + sub "2" + "O";

. 编译产物：
<p>这是一段文字，其中<strong>重要</strong>的部分会被加粗</p>
<p>价格：<del>99元</del> 现价 49元</p>
<p>快捷键是<code>Ctrl+C</code>复制</p>
<p>水的化学式是 H<sub>2</sub>O</p>

. 注意：使用 + 号连接不同样式的文本片段


.
. 四、链接 (Links)
. ------------------------------------------------------------------------------
. HTML 中的 <a> 标签
.

关键字      HTML 等价       说明
─────       ─────────       ─────────────────────────────────────────
link        <a>             超链接
mail        <a href="mailto:">  邮件链接

. 使用示例：
link "访问旧版网址" to "https://www.blackstop.neocities.org";
link "B站主页" to "https://bilibili.com" <newTab>;
mail "biliblackstop@163.com";

. 编译产物：
<a href="https://www.blackstop.neocities.org">访问旧版网址</a>
<a href="https://bilibili.com" target="_blank">B站主页</a>
<a href="mailto:biliblackstop@163.com">biliblackstop@163.com</a>

. 注意：to 后面跟 URL 地址
.       <newTab> 表示在新标签页打开（编译为 target="_blank"）


.
. 五、分割线与换行 (Dividers & Breaks)
. ------------------------------------------------------------------------------
.

关键字      HTML 等价       说明
─────       ─────────       ─────────────────────────────────────────
line        <hr>            水平分割线（无内容时）
br          <br>            强制换行

. 使用示例：
line <longDistance=100px, color=red>;
line <color=#334155>;
text "第一行" + br + "第二行";

. 编译产物：
<hr style="width:100px; color:red; background-color:red; border:none; height:1px;">
<hr style="color:#334155; background-color:#334155; border:none; height:1px;">
<p>第一行<br>第二行</p>


.
. 六、列表 (Lists)
. ------------------------------------------------------------------------------
. HTML 中的 <ul> <ol> <li>
.

关键字      HTML 等价       说明
─────       ─────────       ─────────────────────────────────────────
ul          <ul>            无序列表（圆点）
ol          <ol>            有序列表（数字）
li          <li>            列表项

. 使用示例：
ul {
    li "起床战争";
    li "PVP";
    li "布吉岛";
};

ol {
    li "注册 Ojar 账户";
    li "登录系统";
    li "观看视频";
};

. 编译产物：
<ul>
    <li>起床战争</li>
    <li>PVP</li>
    <li>布吉岛</li>
</ul>
<ol>
    <li>注册 Ojar 账户</li>
    <li>登录系统</li>
    <li>观看视频</li>
</ol>


.
. 七、引用与代码块 (Quotes & Preformatted)
. ------------------------------------------------------------------------------
.

关键字      HTML 等价       说明
─────       ─────────       ─────────────────────────────────────────
quote       <blockquote>    块级引用，用于大段引用文字
q           <q>             行内引用，短引用
pre         <pre>           预格式化文本，保留空格和换行
code        <code>          行内代码
codesnippet <pre><code>     代码块，多行代码

. 使用示例：
quote "这是一段被引用的文字，通常会有缩进和左边框样式";

text "他说" + q "你好世界" + "然后走了";

pre "
int main() {
    printf(\"Hello, Ojar!\");
    return 0;
}
";

. 编译产物：
<blockquote>这是一段被引用的文字，通常会有缩进和左边框样式</blockquote>
<p>他说<q>你好世界</q>然后走了</p>
<pre>
int main() {
    printf("Hello, Ojar!");
    return 0;
}
</pre>


.
. 八、完整示例 (Complete Example)
. ------------------------------------------------------------------------------
. 下面是一段完整的 OjarLang 页面，展示所有文本关键字的使用
.

head () {
    Title:"BlackStop SPACE",
    Type:"PC Web Page",
    Version:"0.1";
}

body () {
    . 标题层级
    title "BlackStop's SPACE";
    title2 "关于我";

    . 段落文本
    text "Hey Bro，我是黑祉_YUMMY，准初中生。";
    text "起床战争打的" + bold "十分的菜" + "，PVP 也" + italic "不怎么样" + "。";

    . 分割线
    line <longDistance=80%, color=#334155>;

    . 列表
    text "我的技能：";
    ul {
        li "Minecraft 起床战争（菜）";
        li "PVP（也菜）";
        li "编程（勉强）";
    };

    . 链接
    text "联系我：" + mail "biliblackstop@163.com";

    . 引用
    quote "旧版网址已废弃，新内容在此发布";

    . 代码展示
    text "我的第一个 Ojar 程序：";
    pre "title \"Hello,Ojar\";";
}


.
. 九、关键字速查表 (Quick Reference)
. ------------------------------------------------------------------------------
.

┌─────────────┬──────────────┬──────────────────────────────────────┐
│ Ojar 关键字 │  HTML 等价   │  说明                                  │
├─────────────┼──────────────┼──────────────────────────────────────┤
│ title       │  <h1>        │  一级标题                             │
│ title2     │  <h2>        │  二级标题                              │
│ title3     │  <h3>        │  三级标题                              │
│ title4     │  <h4>        │  四级标题                              │
│ title5     │  <h5>        │  五级标题                              │
│ title6     │  <h6>        │  六级标题                              │ 
│ text       │  <p>         │  段落文本                              │
│ line       │  <span>/<hr> │  行内文本 /分割线( 视上下文)             │
│ block      │  <div>       │  块级容器                              │
│ raw        │  (无)        │  纯文本                                │
│ bold       │  <strong>    │  加粗强调                              │
│ italic     │  <em>        │  斜体强调                              │
│ underline  │  <u>         │  下划线                                │
│ strike     │  <del>       │  删除线                                │
│ highlight  │  <mark>      │  高亮                                 │
│ code       │  <code>      │  行内代码                              │
│ small      │  <small>     │  小号字                                │
│ sub        │  <sub>       │  下标                                  │
│ sup        │  <sup>       │  上标                                  │
│ link       │  <a>         │  超链接                              │
│ mail       │  <a mailto>  │  邮件链接                            │
│ br         │  <br>        │  换行                                │
│ ul         │  <ul>        │  无序列表                            │
│ ol         │  <ol>        │  有序列表                            │
│ li         │  <li>        │  列表项                              │
│ quote      │  <blockquote>│  块引用                              │
│ q          │  <q>         │  行内引用                            │
│ pre        │  <pre>       │  预格式化                            │
└─────────────┴──────────────┴──────────────────────────────────────┘

.
. 十、样式语法补充
. ------------------------------------------------------------------------------
. 所有文本关键字都支持尖括号 < > 内联样式
.

关键字      HTML 样式属性映射
─────       ─────────────────────────────────────────
color       → color（文字颜色）
bgColor     → background-color（背景色）
fontSize    → font-size（字号）
fontFamily  → font-family（字体）
bold        → font-weight: bold（加粗）
italic      → font-style: italic（斜体）
align       → text-align（对齐：left/center/right）
lineHeight  → line-height（行高）
spacing     → letter-spacing（字间距）

. 使用示例：
text "红色大字" <color=red, fontSize=24px>;
title "居中标题" <align=center>;
text "蓝色链接" <color=#3b82f6, underline>;

================================================================================
  End of Document
  OjarLang © BlackStop 2026
================================================================================